home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 4 / bday13.zip / BDAY.DOC < prev    next >
Text File  |  1990-02-01  |  12KB  |  387 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                                                 B d a y
  19.         _______________________________________________________________
  20.  
  21.                                                                v1.3/GAP
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                                                   Copyright (c) 1989 by
  38.                                               Dyne Software Development
  39.                                                     All Rights Reserved
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.         Copyright Notice
  59.  
  60.         Bday v1.3/GAP is copyright (c) 1990 by Larry Antram and Dyne
  61.         Software Development. All Rights Reserved.
  62.  
  63.  
  64.         License Statement
  65.  
  66.         You are granted a limited licence to use Bday for an
  67.         evaluation period not to exceed 30 days. At such time you must
  68.         either register your copy or quit using it.
  69.  
  70.  
  71.         Shareware
  72.  
  73.         Bday is not a free program.  It is being distrubuted under
  74.         the shareware 'try before you buy' concept.
  75.  
  76.         If you find this program useful then please register it. A fee
  77.         of $10 is not unreasonable and can be reimbursed to:
  78.  
  79.                         Dyne Software Development
  80.                         Attn: Larry Antram
  81.                         25144-A Steinbeck Avenue
  82.                         Stevenson Ranch, CA 91381
  83.  
  84.         You will receive a personalized registered (and a shareware)
  85.         copy of the newest version. Registered users can update to the
  86.         newest version at any time by returning the orginal disk with
  87.         a short note requesting an update.
  88.  
  89.  
  90.         Warranty
  91.  
  92.         Bday is provided as is with out warranty of any kind either
  93.         express or implied.
  94.  
  95.         The author has taken due care in the creation of this program and
  96.         manual and cannot not be held responsable for its use or misuse.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.         Introduction
  113.  
  114.         Bday is a utility created for the Gap v4.x computer bulletin
  115.         board system.
  116.  
  117.         It allows for the quick and easy creation of a users birthday
  118.         listing notice.
  119.  
  120.  
  121.         Distribution Files
  122.  
  123.         The following files should have been included in the Bday
  124.         distribution archive.
  125.  
  126.             BDAY_13.ZIP  ──────────┐
  127.                                    │
  128.                                    
  129.                       BDAY    .COM - Com version of Bday
  130.                       BDAY    .EXE - Exe version of Bday
  131.                       BDAY    .DOC - Documentation
  132.                       HISTORY .TXT - Version history
  133.                       REGISTER.TXT - Registration form
  134.                       READ    .ME  - Misc. info (may not be present)
  135.                       BDAYHI       - Optional header
  136.                       BDAYHIG      - Optional header (graphics)
  137.                       BDAYBYE      - Optional trailer
  138.                       BDAYBYEG     - Optional trailer (graphics)
  139.                       EVENT1  .BAT - Sample EVENT1 file
  140.                       EVENT2  .BAT - Sample EVENT2 file
  141.                       SAMPLE       - Sample output
  142.                       SAMPLEG      - Sample output (ansi)
  143.  
  144.  
  145.         Set Up
  146.  
  147.         Bday is an intelligent program. At a minimum, you need only
  148.         supply it a single command line arguement.  It will derive
  149.         the rest of its configuration defaults directly from the Gap
  150.         system files.
  151.  
  152.         It can be placed anywhere on your system, even in a path
  153.         statement. The single requirement is, that upon execution, a
  154.         copy of GAPBBS.CNF *must* reside in the same directory as the
  155.         Bday files.
  156.  
  157.         The easiest configuration would be the placement of the Bday
  158.         files directly into your Gap system directory. Bday can also
  159.         be easily placed into it's own directory.
  160.  
  161.         Depending upon the options you choose, the particular Bday files
  162.         needed would range between the following 2 examples.
  163.  
  164.         Example #1 - Generate predefined output screens, files needed:
  165.  
  166.  
  167.                         BDAY.EXE   or   BDAY.COM
  168.  
  169.         Example #2 - Generate customized output screens, files needed:
  170.  
  171.                         BDAY.EXE   or   BDAY.COM
  172.                         BDAYHI
  173.                         BDAYHIG
  174.                         BDAYBYE
  175.                         BDAYBYEG
  176.  
  177.         Note that the 2 examples are a range. You need not supply all of
  178.         the files if not desired.
  179.  
  180.         Both the .EXE and .COM versions are supplied. They are the exact
  181.         same program, so you can determine which format better suits
  182.         your needs.
  183.  
  184.  
  185.         Usage
  186.  
  187.         By typing BDAY, without any command line parameters, the
  188.         following summary help screen will be displayed:
  189.  
  190.   ┌───────────────────────────────────────────────────────────────────────┐
  191.   │        Bday v1.3/GAP                   Written by Larry Antram        │
  192.   │ Copyright (c) 1990 by Dyne Software Development. All rights reserved. │
  193.   │ _____________________________________________________________________ │
  194.   │                                                                       │
  195.   │ Usage:     BDAY <switches> [color]                                    │
  196.   │                                                                       │
  197.   │ Switches:  /S[G]       = Display to screen       (G = graphics)       │
  198.   │            /N<#>       = Create News File        (# = 0-9)            │
  199.   │            /B<#>       = Create Bulletin File    (# = 0-maxblt)       │
  200.   │            /F:filename = Create to path/filename                      │
  201.   │                                                                       │
  202.   │ Colors:    1 = Red    2 = Green     3 = Yellow                        │
  203.   │            4 = Blue   5 = Magenta   6 = Cyan                          │
  204.   │                                                                       │
  205.   │            <> = required,   [] = optional                             │
  206.   │                                                                       │
  207.   │ Examples:   bday /n5       (generates NEWS5, NEWS5G or none)          │
  208.   │             bday /b23 6    (generates BLT23, BLT23G, cyan coloring)   │
  209.   │             bday /f:hb.100 (generates HB.100, HBG.100)                │
  210.   │             bday /sg       (generates to stdio w/ ansi graphics)      │
  211.   │                                                                       │
  212.   │ Exit Codes: 0 = Success                                               │
  213.   │             1 = Failure                                               │
  214.   └───────────────────────────────────────────────────────────────────────┘
  215.  
  216.         The following is an example and explaination of the different
  217.   methods and switches.
  218.  
  219.         BDAY /S[g] - This will allow you to direct the output to the
  220.  
  221.                   Standard Output device. Generally this will be your
  222.                   screen. Redirection is certainly possible but not
  223.                   needed.
  224.                   Graphics output can be generated by appending a G to
  225.                   this switch. (ie. BDAY /SG)
  226.  
  227.         BDAY /Nx (where x = 0 to 9) - This command sequence will
  228.                   create the appropriate NEWSx and NEWSGx files. Use
  229.                   a 0 when you wish to create the NEWS or NEWSG file.
  230.                   If there are no birthdays for the current day, then
  231.                   the news files will not be created, and the old NEWSx,
  232.                   NEWSGx will be deleted.
  233.                   If you specify and incorrect or to large of a
  234.                   parameter for x then Bday will display the help
  235.                   summary screen.
  236.  
  237.         BDAY /Bx (where x = 0 to max_bulletins) - This switch will
  238.                   allow you specify that you wish to generate
  239.                   Bday output as a bulletin. Simply replace xx
  240.                   with the approprate number. Both the BLTx and
  241.                   BLTGx bulletins will be created. Bday will not
  242.                   write to a bulletin which is out of range.
  243.                   The /B option (unlike the /N option) will generate the
  244.                   output files even if there are no birthdays for the
  245.                   current day (an appropriate message will be used
  246.                   instead).
  247.  
  248.         BDAY /F:filename - Bday also allows you to specify a dos
  249.                   path/filename. For example if you wished for the
  250.                   Bday output to be directed to a file called
  251.                   HAPPYB, then specify it on the command line. The
  252.                   HAPPYBG file will also be automatically created.
  253.                   You can specify a full path if so desired. (ie.
  254.                   POSTCALL /F:D:\FORUMS\FM1\MESSAGE.TXT). Bday is
  255.                   smart enough to write it and the coresponding
  256.                   D:\FORUMS\FM1\MESSAGEG.TXT file.
  257.  
  258.  
  259.         The color parameter is a number between 1 and 6, passed on the
  260.         command line after the switches.
  261.  
  262.                   BDAY <switches> [color number]
  263.  
  264.         The following is a listing of the colors and the respective
  265.         parameter number:
  266.  
  267.                         1       Red
  268.                         2       Green
  269.                         3       Yellow
  270.                         4       Blue
  271.                         5       Magenta
  272.                         6       Cyan
  273.                                                                                               │
  274.         This is an optional item and need not be included. Bday will
  275.  
  276.  
  277.         default to Cyan.
  278.  
  279.         Optional Files
  280.  
  281.         You can customize Bday by providing your own optional header and
  282.         trailer files.
  283.  
  284.         If present the BDAYHI or BDAYHIG will replace the predefined
  285.         title header. This file will be shown right before the current
  286.         birthdays of the day.
  287.  
  288.         If present the BDAYBYE or BDAYBYEG will be shown immedately
  289.         after the current birthdays of the day list.
  290.  
  291.         Bday will look for these files in the default directory and if
  292.         not found, will use it's own internal screen displays.
  293.  
  294.  
  295.         Exit Code
  296.  
  297.         Bday will issue an exit code of 1 upon error. An exit code
  298.         of 0 signifies a successful exectution.
  299.  
  300.         These are provided for use with batch files. Access can be
  301.         accomplished via the dos errorlevel variable.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331. -------------- B D A Y   R E G I S T R A T I O N   F O R M ------------------
  332.  
  333.                           Bday v1.3/GAP - 1/31/90
  334.  
  335.  
  336. Name ________________________________________________________________________
  337.  
  338. Address _____________________________________________________________________
  339.  
  340. City ________________________________ State __________ ZipCode ______________
  341.  
  342. Phone Number ________________________________________________________________
  343.  
  344. Exact full name (for registration notice) ___________________________________
  345.  
  346. Exact BBS Name (for registration notice) ____________________________________
  347.  
  348.  
  349. Disk Media (check one):    5 1/4" 360k _______      OR     3 1/2" 720k ______
  350.  
  351.  
  352.  
  353.                         Registration            ___$10__
  354.  
  355.                         Upgrade Disk            __free__
  356.  
  357.                         Shipping (via USPS)     __free__
  358.  
  359.                       --------------------------------------
  360.  
  361.                         Total Enclosed          __$10 __
  362.  
  363.  
  364.  
  365.                 Remit to:
  366.  
  367.                          Dyne Software Development
  368.                          Attn: Larry Antram
  369.                          25144-A Steinbeck Avenue
  370.                          Stevenson Ranch, CA 91381
  371.  
  372.  
  373.  
  374. Where did you obtain Bday? ___________________________________________________
  375.  
  376. Suggestions or comments ______________________________________________________
  377.  
  378. ______________________________________________________________________________
  379.  
  380. ______________________________________________________________________________
  381.  
  382. ______________________________________________________________________________
  383.  
  384.                      *** Thank you for your support! ***
  385.  
  386.  
  387.